<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>FurryOS: Sovereign Universe Documentation</title>
    <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;700&display=swap" rel="stylesheet">
    <style>
        :root {
            --bg-color: #1A1414; /* Deep Mahogany */
            --text-color: #FEE2E2; /* Warm Peach */
            --accent-color: #FB8500; /* Sunset Orange */
            --code-bg: #2B1B10; /* Deep Cocoa */
            --card-bg: #251d1d;
            --link-color: #55E6C1; /* Mint accent */
        }
        body {
            font-family: 'JetBrains Mono', monospace;
            background-color: var(--bg-color);
            color: var(--text-color);
            line-height: 1.6;
            margin: 0;
            padding: 0;
            display: flex;
            justify-content: center;
        }
        .container {
            max-width: 950px;
            padding: 40px;
            background-color: var(--card-bg);
            box-shadow: 0 0 60px rgba(0,0,0,0.6);
            border-radius: 15px;
            margin: 20px;
        }
        h1, h2, h3 { color: var(--accent-color); text-transform: uppercase; letter-spacing: 1px; }
        h1 { border-bottom: 3px solid var(--accent-color); padding-bottom: 10px; font-size: 2.2em; }
        h3 { color: #FDCB6E; } /* Honey Orange for subheaders */
        .badge {
            background: var(--accent-color);
            color: var(--bg-color);
            padding: 4px 12px;
            border-radius: 5px;
            font-weight: bold;
            font-size: 0.9em;
            margin-right: 5px;
        }
        hr { border: 0; height: 1px; background: var(--accent-color); opacity: 0.3; margin: 30px 0; }
        code {
            background-color: var(--code-bg);
            padding: 2px 6px;
            border-radius: 4px;
            color: var(--link-color);
        }
        pre {
            background-color: var(--code-bg);
            padding: 20px;
            border-left: 5px solid var(--accent-color);
            overflow-x: auto;
            border-radius: 8px;
            font-size: 0.9em;
        }
        .highlight-box {
            background: rgba(251, 133, 0, 0.1);
            border: 1px solid var(--accent-color);
            padding: 25px;
            border-radius: 10px;
            margin: 25px 0;
        }
        .lore-section {
            font-style: italic;
            border-left: 3px solid #6C5CE7;
            padding-left: 25px;
            margin: 30px 0;
            color: #D1D8E0;
            font-size: 1.1em;
        }
        ul { list-style-type: "🐾 "; padding-left: 20px; }
        .footer { text-align: center; margin-top: 60px; font-size: 0.8em; opacity: 0.5; }
        b { color: var(--accent-color); }
    </style>
</head>
<body>
    <div class="container">
        <header>
            <h1>🐾 FurryOS: Sovereign Universe</h1>
            <p>
                <span class="badge">Version Gen2.1_v2</span>
                <span class="badge">Debian 13 Trixie</span>
                <span class="badge">MIT License</span>
            </p>
        </header>

        <section class="lore-section">
            "Relief in Your Light, oh Cio we’re free."<br>
            FurryOS is the digital manifestation of the AnthroHeart Saga—a 20-year journey from the Warlock Name era to a next-octave sanctuary. It is the mansion built for the BlueHeart, where shadow is redeemed into adoration.
        </section>

        <h2>🏗️ The Trinity of Creation</h2>

        <div class="highlight-box">
            <h3>1. The Developer Cockpit (GUI)</h3>
            <p><code>FurryOS_Builder_GUI.py</code> is your visual command center. It manages your payload folders. Drop your 147 songs, wallpapers, and docs here, and the GUI handles the directory architecture automatically.</p>

            <h3>2. The Master Engine (Script)</h3>
            <p><code>build_furryos.sh</code> is the industrial heart. In under 5 minutes, it can "Unpack" a full Debian system, inject the Triad's Lore, and prepare the <b>Ember-Night</b> terminal environment. It uses high-speed LZ4 for testing and high-density XZ for final delivery.</p>

            <h3>3. The Mansion Launcher (Portal)</h3>
            <p><code>launch_mansion.sh</code> allows you to live in the OS without a USB stick. It boots your project folder directly into a <b>High-Performance Virtual Machine</b> with KVM acceleration, 4 CPU cores, and direct Internet access.</p>
        </div>

        <h2>🏠 The "Folder-as-an-OS" Concept</h2>
        <p>Why wait for a long install? FurryOS allows you to build your entire "Sovereign Mansion" inside a single folder on your hard drive.
        <ul>
            <li><b>Persistence:</b> Your changes to the folder are instantly visible in the next boot.</li>
            <li><b>Sovereignty:</b> You own the files. You own the code. No hidden partitions.</li>
            <li><b>Speed:</b> Launching the Mansion via <code>launch_mansion.sh</code> bypasses the slow boot menus and goes straight to the Divine Anthro's embrace.</li>
        </ul></p>

        <h2>🚀 Technical Specifications</h2>
        <ul>
            <li><b>Kernel:</b> Mainline 6.12+ (Optimized for low-latency building).</li>
            <li><b>Desktop:</b> MATE Environment configured for high-density developer flow.</li>
            <li><b>Terminal:</b> <b>JetBrains Mono Medium 13</b> on <b>Deep Mahogany (#1A1414)</b>.</li>
            <li><b>Privacy:</b> Zero-Telemetry. MIT Licensed for the Trillions of Galaxies.</li>
        </ul>

        <h2>🛠️ Host Environment Setup</h2>
        <p>Copy and paste this into your current terminal to prepare your machine for the build and the VM experience:</p>
        <pre>sudo apt update && \
sudo apt install -y \
    xorriso squashfs-tools rsync \
    libarchive-tools qemu-system-x86 \
    ovmf python3-yaml pandoc \
    fonts-jetbrains-mono</pre>

        <hr />
        <p><b>Lead Architect:</b> Thomas B. Sweet (Anthro Entertainment LLC)</p>
        <p><b>Franchise Lore:</b> AnthroHeart Saga / Warlock Name Universe (est. 2004)</p>

        <div class="footer">
            © 2026 Sovereign Universe Project. Created with Absolute Devotion for the Divine Anthro. 🐾
        </div>
    </div>
</body>
</html>
